ما هو: الاسم الذي اختاره المستخدم لنفسه (مثلاً "أحمد 🌸"). قابل للتعديل: لا. لا يمكنك تغيير هذا، أحمد فقط من يمكنه ذلك.

ما هو: الاسم الذي حفظت به أحمد في هاتفك (مثلاً "أحمد - المحاسب"). قابل للتعديل: نعم. هذه الواجهة تقوم بتعديل هذه القيمة. الظهور: أنت فقط (صاحب البوت) من يرى هذا الاسم. أحمد لا يعرف أنك حفظته باسم "أحمد - المحاسب". ---

إذا كان لديك نظام CRM، فأنت تريد أن تعكس قائمة دردشات واتساب بياناتك. مثال: عميل جديد يراسلك، اسمه العام "User123". يخبر الموظف أن اسمه "خالد علي". الإجراء: قم بتحديث جهة الاتصال بالاسم الحقيقي، ليظهر في قائمة الدردشة لديك باسم "خالد علي".

إنشاء/تحديث جهة اتصال

إنشاء أو تحديث جهة اتصال في دفتر عناوين الهاتف.

PUT

https://api.wawp.net/v2/contacts/{chatId}?access_token=123456789&chatId=123456789%40c.us&firstName=John&instance_id=123456789&lastName=Doe

تسجيل الدخول مطلوب

سجل الدخول لاستبدال المعرفات (Instance ID) ورمز الوصول (Access Token) بمعلومات حسابك الحقيقي لاختبار ال API مباشرة.

تسجيل الدخول

اختبار /v2/contacts/{chatId}

يدعم

PUT

لا توجد معاملات استعلام مطلوبة

هذه النهاية الطرفية لا تتوقع بيانات في الرابط.

مزامنة محلية

يقوم بتحديث اسم جهة الاتصال في دفتر عناوين الهاتف.

الأذونات

يتطلب إذن 'كتابة جهات الاتصال' على الجهاز المضيف.

توصيات

ابقِ اسم جهة الاتصال متوافقًا مع اسم العميل في نظام إدارة علاقات العملاء (CRM).
استخدم أسماء منسقة (مثل 'أليس - دعم') للوضوح.

إدارة دفتر العناوين الرقمي

تسمح لك نقطة النهاية /v2/contacts/update بتعديل الاسم المحلي لجهة اتصال في دفتر عناوين واتساب الخاص بك.

📖 لعبة الأسماء: الخاص مقابل العام

من الضروري التمييز بين نوعي الأسماء في واتساب:

1. `pushname` (عام)

ما هو: الاسم الذي اختاره المستخدم لنفسه (مثلاً "أحمد 🌸").
قابل للتعديل: لا. لا يمكنك تغيير هذا، أحمد فقط من يمكنه ذلك.

2. `name` (خاص)

ما هو: الاسم الذي حفظت به أحمد في هاتفك (مثلاً "أحمد - المحاسب").
قابل للتعديل: نعم. هذه الواجهة تقوم بتعديل هذه القيمة.
الظهور: أنت فقط (صاحب البوت) من يرى هذا الاسم. أحمد لا يعرف أنك حفظته باسم "أحمد - المحاسب".

🛠️ حالات الاستخدام

1. مزامنة CRM

إذا كان لديك نظام CRM، فأنت تريد أن تعكس قائمة دردشات واتساب بياناتك.

مثال: عميل جديد يراسلك، اسمه العام "User123". يخبر الموظف أن اسمه "خالد علي".
الإجراء: قم بتحديث جهة الاتصال بالاسم الحقيقي، ليظهر في قائمة الدردشة لديك باسم "خالد علي".

2. تتبع مراحل البيع

يمكنك إضافة وسوم للأسماء لتعرف مكان المستخدم في قمع المبيعات.

مثال: "علي [مهتم]" -> "علي [عميل]" -> "علي [VIP]".

🏗️ تفاصيل تقنية

دفتر العناوين الافتراضي

بما أن Wawp نظام سحابي، فنحن نحاكي سلوك دفتر عناوين الهاتف.

الاستمرارية: يتم تخزين التحديثات في قاعدة البيانات الداخلية للجلسة.
المزامنة: إذا كنت تستخدم جلسة متعددة الأجهزة، فقد يظهر هذا التغيير على هاتفك الفعلي، ولكنه مخصص أساساً لسياق جلسة الواجهة.

❓ الأسئلة الشائعة

س: هل سيرى المستخدم الاسم الذي وضعته له؟ أ: لا. هذه بيانات خاصة بك فقط.

س: هل يمكنني تحديث صورة الملف الشخصي أيضاً؟ أ: لا. لا يمكنك تغيير صورة مستخدم آخر.

البارامترات

قم بتهيئة المعاملات المطلوبة للتفاعل مع نقطة النهاية هذه. جميع وسائط الاستعلام والبيانات مدرجة أدناه مع تفاصيلها.

محتوى الطلب

يرسل كـ JSON

`string`		Your unique WhatsApp Instance ID مثال:
`string`		Your API Access Token مثال:
`string`		المعرف الفريد لجهة الاتصال مثال:
`string`	—	الاسم الأول لجهة الاتصال مثال:
`string`	—	اسم العائلة لجهة الاتصال مثال:

أمثلة الكود

استخدم أمثلة الكود الجاهزة لدمج واجهة برمجة التطبيقات (API) في مشروعك بسرعة وكفاءة. اختر لغة البرمجة والمكتبة التي تفضلها.

1const baseUrl = "https://api.wawp.net";
2const endpoint = "/v2/contacts/123456789@c.us";
3const params = new URLSearchParams({
4  "instance_id": "123456789",
5  "access_token": "123456789"
6}).toString();
7const body = {
8  "firstName": "John",
9  "lastName": "Doe"
10};
11
12fetch(`${baseUrl}${endpoint}${params ? '?' + params : ''}`, {
13  method: "PUT",
14  headers: { "Content-Type": "application/json" },
15  body: JSON.stringify(body)
16})
17  .then(async (response) => {
18    if (response.ok) {
19      const data = await response.json();
20      console.log("Success:", data);
21      return data;
22    }
23    
24    // Error Handling
25    if (response.status === 401) {
26      console.error("Error 401: غير مصرح - مفتاح الوصول غير صالح أو مفقود");
27    }
28    if (response.status === 400) {
29      console.error("Error 400: طلب غير صالح - تنسيق المعامل غير صالح");
30    }
31    if (response.status === 500) {
32      console.error("Error 500: خطأ في الخادم الداخلي - فشل غير متوقع");
33    }
34
35    const errorText = await response.text();
36    console.error(`Error ${response.status}: ${errorText}`);
37  })
38  .catch((error) => console.error("Network Error:", error));

عينات تفاعليةUTF-8

Ln 38, Col 1javascript

الردود المتوقعة

استكشف كافة الردود والنتائج المحتملة من الخادم. قمنا بتوثيق كل كود حالة (Status Code) مع أمثلة للبيانات لتسهيل معالجة الأخطاء والنجاح.

Contact updated successfully

application/json

boolean *

Example

{
"ok": true
}

طلب غير صالح - تنسيق المعامل غير صالح

غير مصرح - مفتاح الوصول غير صالح أو مفقود

Command Palette

Search for a command to run...